a11y: Add bounds change api

Add a way for GTK to pass bounds change information
to the AT context.

diff --git a/gtk/gtkaccessible.c b/gtk/gtkaccessible.c
index 582cdf08fd841e8f20071c660f3abca4086d0a94..bef2ced14eb2de9c0f832a982603cf6c00f40016 100644 (file)
--- a/gtk/gtkaccessible.c
+++ b/gtk/gtkaccessible.c
@@ -699,6 +699,33 @@ gtk_accessible_get_platform_state (GtkAccessible              *self,
   return GTK_ACCESSIBLE_GET_IFACE (self)->get_platform_state (self, state);
 }
 
+/*<private>
+ * gtk_accessible_bounds_changed:
+ * @self: a #GtkAccessible
+ *
+ * This function can be used to inform ATs that an
+ * accessibles bounds (ie its screen extents) have
+ * changed.
+ *
+ * Note that the bounds are not included in this API.
+ * AT backends should use widget API to obtain them.
+ */
+void
+gtk_accessible_bounds_changed (GtkAccessible *self)
+{
+  GtkATContext *context;
+
+  if (GTK_IS_WIDGET (self) &&
+      gtk_widget_get_root (GTK_WIDGET (self)) == NULL)
+    return;
+
+  context = gtk_accessible_get_at_context (self);
+  if (context == NULL)
+    return;
+
+  gtk_at_context_bounds_changed (context);
+}
+
 /*<private>
  * gtk_accessible_should_present:
  * @self: a #GtkAccessible

diff --git a/gtk/gtkaccessibleprivate.h b/gtk/gtkaccessibleprivate.h
index b3984e3cbdaca03804d6e4dd391085425fef4715..966efc3abba001289ca6fa4090b79a71ea9e70e6 100644 (file)
--- a/gtk/gtkaccessibleprivate.h
+++ b/gtk/gtkaccessibleprivate.h
@@ -47,4 +47,6 @@ void            gtk_accessible_platform_changed (GtkAccessible                *s
 gboolean        gtk_accessible_get_platform_state (GtkAccessible              *self,
                                                    GtkAccessiblePlatformState  state);
 
+void            gtk_accessible_bounds_changed   (GtkAccessible *self);
+
 G_END_DECLS

diff --git a/gtk/gtkatcontext.c b/gtk/gtkatcontext.c
index 70608a2cb454233036fa2255507cfa50caa49c16..1925f5bf808efb1b2b8bc9986460edfeefd72ef7 100644 (file)
--- a/gtk/gtkatcontext.c
+++ b/gtk/gtkatcontext.c
@@ -150,6 +150,11 @@ gtk_at_context_real_platform_change (GtkATContext                *self,
 {
 }
 
+static void
+gtk_at_context_real_bounds_change (GtkATContext *self)
+{
+}
+
 static void
 gtk_at_context_class_init (GtkATContextClass *klass)
 {
@@ -161,6 +166,7 @@ gtk_at_context_class_init (GtkATContextClass *klass)
 
   klass->state_change = gtk_at_context_real_state_change;
   klass->platform_change = gtk_at_context_real_platform_change;
+  klass->bounds_change = gtk_at_context_real_bounds_change;
 
   /**
    * GtkATContext:accessible-role:
@@ -820,3 +826,9 @@ gtk_at_context_platform_changed (GtkATContext                *self,
 {
   GTK_AT_CONTEXT_GET_CLASS (self)->platform_change (self, change);
 }
+
+void
+gtk_at_context_bounds_changed (GtkATContext *self)
+{
+  GTK_AT_CONTEXT_GET_CLASS (self)->bounds_change (self);
+}

diff --git a/gtk/gtkatcontextprivate.h b/gtk/gtkatcontextprivate.h
index 872c91e6982af95e8c275f271436cf28c6e5b75b..d1495538c147a36072b4515635f824b0f5d4ab8e 100644 (file)
--- a/gtk/gtkatcontextprivate.h
+++ b/gtk/gtkatcontextprivate.h
@@ -122,6 +122,8 @@ struct _GtkATContextClass
 
   void (* platform_change) (GtkATContext                *self,
                             GtkAccessiblePlatformChange  changed_platform);
+
+  void (* bounds_change) (GtkATContext                *self);
 };
 
 GdkDisplay *            gtk_at_context_get_display              (GtkATContext          *self);
@@ -154,6 +156,7 @@ char *                  gtk_at_context_get_label                (GtkATContext
 
 void                    gtk_at_context_platform_changed         (GtkATContext                *self,
                                                                  GtkAccessiblePlatformChange  change);
+void                    gtk_at_context_bounds_changed           (GtkATContext                *self);
 
 const char *    gtk_accessible_property_get_attribute_name      (GtkAccessibleProperty property);
 const char *    gtk_accessible_relation_get_attribute_name      (GtkAccessibleRelation relation);